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Scope 


To design a Cinema Booking System 


The site is used by consumers to book movie tickets. 
Given a city, there are several theatres available. 

Each theatre may have multiple screens. 

Each screen may play multiple shows, with a different 
movie per show. 

Each theatre may have a different seating arrangement. 
When a user enters the site, he may search by a theatre 
or movie. 

Based on the search results, user selects and books a 
ticket. 

Each ticket may reserve up to 6 seats. 

Booking must include a confirmed online payment. 

On booking, user is notified via an SMS and email. 


Architecture principles and guidelines 


Service 
replication 


Each service need to replicate, typically 
either Vertically or Horizontally. 


The most freguently used functionality is the Search 
functionality for the entire website. The service needs to 
replicate either Vertically or Horizontally as the quantum 
of search requests increases. Kubernetes provide a great 
way to replicate services easily using Replication 
Controller. Also with Autoscaling enabled in AWS would 
enable the container to scale vertically and horizontally. 


Service 
discovery 


Multiple services might be collaborating to 
provide an application's functionality. 


Booking service needs data from Movie, Screen, Theatre 
etc.. Related services to initiate the ticket booking for the 
user. This requires the API gateway to identify and obtain 
the necessary handle . The API Gateway uses the Service 
Registry to perform service discovery. Netflix Eureka 
provides a good option for Service discovery. Netflix 
Eureka achieves high availability by running one or more 
Eureka servers in each Amazon EC2 availability zone. 


Resiliency 


High Availability and Disaster recovery 


For HA and DR its very important for services to 
automatically take corrective action and ensure the user 
experience is not impacted. For example, Netflix's Hystrix 
provide an implementation of Circuit Breaker pattern to 
deal with software resiliency. 


Consistency 


o maintain consistency when performing 
transactions 


Use SQL where transactions should follow consistency and 
transaction level ACID properties need to be taken care off. 
Like ticket booking, updating the status from available to 
blocked to booked since it requires db transactions etc. 
AWS RDS provides a great facility for data replication and 
consistency in AWS. 


Architecture principles and guidelines 
Design Principle Besten Uses 


Availability To maintain high availability meeting 99.9896 Use NoSQL while performing searches and mainly on data 
uptime SLAs. retrieval wherever High Availability needs to be achieved. 
Casandra is recommended. 


Elastic Search Seamless search for small and big data sets Excellent choice to perform fast search for large datasets 


(Analytics) with high availability reguirements. As the search load 
increases, this ElasticSearch container can be autoscaled. 
Kafka Queue Queuing of Events for Notifications and Booking and Notifications flows has async operations which 
Delivery could be handled via queues. While booking tickets, there is 


a need to notify external systems. Queue is populated with 
appropriate messages/events along with metadata and the 
receiver service picks up the events and delivers to the 
External system. On Payment confirmation, there is a need 
to deliver SMS/Email to customers and as well notify back to 
the external theatre systems. 


Service Centralised logging easily identifies server Zipkin to gather timing data needed to troubleshoot latency 

monitoring problems or applications. problems in microservice, ELK (Elastic Search, LogStash, 
Kibana) for searching, analyzing, and visualizing log data in 
real-time. 


Allows you to identify any issues spanning multiple servers 
by correlating all the logs within a specified time frame. An 
open source tool which collects and stores logs, Logstash 
indexes the logs, while Kibana , a web interface, is used to 
View and search the logs already indexed. 


Location 


ocation ID (Ri 
Location Name 


Theatre ID (X) 
Location 
Theatre Name 


Payment 
ReservationStatus 
Reservation Type (Web, 
Mobdile) 

Paid Status 
Active Status 
Notifications 


Domain Driven Design 


Screen ID 
CustomArray (RxC) 


SeatSelected TD (K) 
Screen 
Row 


Payment FD {K} 
Payment Type 
Payment Description 


a ai 


initiated (I). 
Saved (Sai, 
Deleted (0), 
Updated (U), 
Blocked (B), 
Payment In Progress (PL), 
Payment Failed (PF), 
Payment Completed (PC), 
Reservation Failed (RP), 
Reservation Canceled (RC), 
Reservation Successful (BS) 


Solution Architecture 


Web / Mobile Client 
5 Client Side 


— Access JSON, JWT | HTTP, Web Socket Notifications 


Token 


Security and Access 
Mgmt 


API Gateway Server Side 


Registry 


t Proprietary Formats 
All services are exposed as REST. 
API Sample shown here. 
Use NoSQL while performing 
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Availability needs to be achieved. 


Use SQL where transactions 
should follow consistency and 
transaction level ACID properties 
need to be taken care off. Like 
ticket booking, updating the status 
I from available to blocked to 
- booked since it requires db 
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Detail Design 


API & Auth Layer Micro Service Layer Admin & System 


Database Layer 
Monitoring Layer y 


API Gateway Web Customer Container 


Container 
API Web Gateway - 


MS 
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Cluster 


Booking Container 
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NOTE: All services are 
configured and managed 
via Kubernetes. Zipkin 
and ELK monitors their 
logs and state transition. 
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Analytics Container (Optional) 
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Enabling Search with Elastic Spring Batch Framework - To trigger 
loading of JSON documents to Elastic 


Search Search Cluster (Spring Container) 
Tw Om bea ata JFF 
Spring Application Context Movies, 
Theatres based 5a. Lookup 


Movies 


on Location Movis 


Microservice 


6. JSON 
representation 9 
movies, screens 


Movie Store 


and theatres 4. Lookup 4a. Return 
4b. Return JSON Screen Details Screen 
- details 


representation of 
Screen 


3a. Return 
b. Return JSON Theatre 
Representation of details 
Theatre 


JavaScheduler 


3. Lookup Theatre 


i Theatre 
Theatre details Microservite 


Store 


2b. Return JSON 
representation of 
Location 


Location 
Microservice 


Location 


2. Lookup Store 


Theatres fora 2a. Return 
location Location details 


7. Push the JSON 
representation of 
movies, screens and 
theatres to the 
ElasticSearch Cluster 


Customer Search Flow 


Elastic Search Container 


1. JSON representation 2. To convert JSON to Java 3. preparelndex() - this 
of movies, screens and Object makes arbitary JSON 
theatres is pushed to document Searchable. 
XContentBuilderService 
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| XContentBuil Jackson -> 

Visits Search request | derservice ObjectMapper preparelndex 
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6. Returns 


SearchService QueryBuilder 


necessary output 
to the customer 
5. Querybuilder finds specific entries in the cluster. 
While using the prepareSearch()method for looking 
data for the search criteria. This is for specific JSON documents in the cluster, we can use 
passed to Jackson and deserialized query builders to customize the search results.. The 
to JSON and sent back to client. indexed data is shard across nodes in the cluster. 


4. Based on the search criteria, 
builds the query and returns the 


Customer Booking Flow 


Customer 
Table 


~~ Booking 
Table 
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7. Store 3.Flow continues till Seat 
Booking | Selection flow, once Seat is 
Customer Details 


Microservice 


SeatSelecte 


selected, the ReservationState in 
Reservatioh Status table is 
updated to “Initiated” and 

dis updated and a 


5. ReceiverService is as well 
triggered via a job and it 
a. Reads the Event and 
Event related Metadata from 
NotificationRece the Queue 
iverService . Formats message in 
necessary format as per 
the Theatre System and 
delivers 
c. This notifies the External 
system to block the 
seats 
d. Receives Ack/Error from 


Event 
NotificationSenderS 
ervice 


4. SenderService is 
triggered via a job and it 
constructs the necessary 
metadata from Booking 
ReservationStatus , 
SeatSelected and Payment 


e TimerEvent is'generated and table and builds a Theatre System pushes 
x» Payment Initiated. respective event and the event 
Ze Booking ` pushes it to Queue. EE / 
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1. Choose the X Microservice X 6.NotificationEventService Message SeatsNotBlockedEvent 
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and initiates 2. JSON représentation d users via SMS / eMails Metadata. 
booking of movies, screens and \ Gateways . Updates the 


theatres are given as 
inputs from Search Flow 
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Confirmation / Failure 
shown to User 


Guest User 


3c. Update 
Payment 


ReservationStatus, 
Notifications and Booking table 
N once Payment is successful. 
Also creates a 
. “BookingSuccessEvent”. 


confirmed. 


Theatre External 


System 


NotificationEventService — 
Notifications 


Table 


3a. Update 
SeatSelected SeatSelected SeatSelected 


3b. Update Microservice Table 
ReservationStatus 


ReservationStatus Reservation 


Microservice Status Table 


Customer Notification Flow 


| On successful booking of tickets, events like 
| 1. SendEmailMesssageEvent 


| Appropriate receiver job pulls in the message from the queue, : 
' constructs the necessary message from the Metadata and sends it ` 
| 2. SendSMSMessageEvent etc., along with e across to the recipient. Updates the necessary DB back with an | 
| necessary MetaData are pushed to the ! Ack/Error Events, along with necessary MetaData. As both SMS | 
| queue by a Sender job... and eMail are “Fire-and-Forget” no Ack/Err is pushed back to the 

| Booking Service and is not considered in this design... | 


1. EmalMesssagesSuccessfullySentEvent 
2. SMSMessageSentEvent etc.. 
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Email Store 
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Gateway 


aa 


Microservices 


Messaging Fabric 


SMSNotification 
Microservice 


SMS Store 
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Deployment Architecture 
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Deployment Architecture 


Containerization 
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